home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / async.zip / ASYNC.DOC < prev    next >
Text File  |  1986-10-10  |  7KB  |  264 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           ASYNC (1)          ASYNC BIOS REPLACEMENT          ASYNC (1)
  68.  
  69.  
  70.      NAME         NAME  
  71.  
  72.           ASYNC.COM 
  73.  
  74.      SYNOPSIS         SYNOPSIS  
  75.  
  76.           async com                   async.com [0|1] 
  77.  
  78.      DESCRIPTION         DESCRIPTION  
  79.  
  80.           async com                                                               async.com  is  a  terminate-and-stay  resident  program that
  81.           replaces the  IBM-PC  ROM-BIOS  asynchronous  communications
  82.           services  with  a servicable interrupt-driven communications
  83.           driver.  
  84.  
  85.                              async 0    async 1                                   To invoke it, type async 0 or async 1 and it takes over  the
  86.           communications port.  Since PC-DOS uses the rom bios INT 14H 
  87.                                       COM1  COM2     AUX                          service  for all I/O on the COM1, COM2 and AUX devices, this
  88.           program becomes the driver for those devices.  
  89.  
  90.                async com                                                           Once async.com becomes resident, all input and output to the 
  91.           com-port devices is run through an interrupt driven hardware 
  92.           driver, that is buffered both on input and output.  
  93.  
  94.           This is especially useful in  conjunction  with  the  PC-DOS
  95.           CTTY                                                                    CTTY command,  which  redirects  the  console  device.   The
  96.           standard ROM-BIOS driver is polled, and has  a  tendency  to
  97.           lose characters at high input and output rates.  
  98.  
  99.      CAVEATS         CAVEATS  
  100.  
  101.                       async com                     CTTY                          If  you use async.com in conjunction with CTTY, keep in mind
  102.           that the CON device is still the PC system  console.    This
  103.                                          COPY CON FILE DAT                        means  that if you try to do a COPY CON FILE.DAT, the system
  104.           is hung until  someone  at  the  physical  console  types  a
  105.           control-Z.  
  106.  
  107.           BASICA                                                                  BASICA   is,  of  course,  a  no-no,  as  it  does  its  own
  108.           communications device handling.  
  109.  
  110.                                                     async com                     If you want to use both async ports with  async.com,  invoke
  111.           it  twice,  once  for  port  0  (com1)  and  once for port 1
  112.           (com2).  I am not sure what happens if you stack  more  than
  113.                       async com                                                    one copy of async.com for a given port, except that I/O will 
  114.           probably  slow  down,  and  more  memory  will  be  used up.
  115.           async com                                                               async.com doesn't check to make sure that it hasn't  already
  116.           been invoked.  
  117.  
  118.           The best way to use async.com for going 'outside' from a BBS 
  119.           is  to  use  the  PD utilities MARK and RELEASE, included in
  120.           this package.   Also  included  is  the  TSR.DOC  file  that
  121.                                        MARK                 async com              describes their use.  If you MARK before invoking async.com, 
  122.                      RELEASE                                                      and  then  RELEASE when you're ready to go back to work, you
  123.                       async com                                                   don't leave async.com dangling in memory.    An  example  is
  124.           included below.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                       -1-
  131.  
  132.  
  133.           ASYNC (1)          ASYNC BIOS REPLACEMENT          ASYNC (1)
  134.  
  135.  
  136.      EXAMPLES         EXAMPLES  
  137.  
  138.           The  following is a batch file for invoking a dos shell from
  139.           a BBS.  You may note that a copy of each command  is  echoed
  140.                  CON                                    CTTY COM1               to the CON device, which is not redirected by CTTY COM1.  
  141.  
  142.                ECHO OFF
  143.                ECHO FMARK \TMP\ASYNC >CON
  144.                FMARK \TMP\ASYNC
  145.                ASYNC 0
  146.                ECHO MODE COM1:96,n,8,1 >CON
  147.                MODE COM1:96,n,8,1
  148.                ECHO CTTY COM1 >CON
  149.                CTTY COM1
  150.                ECHO PC-SHELL >CON
  151.                COMMAND
  152.                ECHO CTTY CON >CON
  153.                CTTY CON
  154.                ECHO RELEASE \TMP\ASYNC >CON
  155.                RELEASE \TMP\ASYNC
  156.  
  157.                   async com                                                       To  use async.com with this batch file (assuming it's called
  158.           outside.bat) : 
  159.  
  160.                ASYNC 0 OUTSIDE
  161.  
  162.  
  163.      FILES         FILES  
  164.  
  165.           Filename        Length   Method     Size   Ratio    Date      Time
  166.           --------        ------   ------    ------  -----    ----      ----
  167.           ASYNC.C            954  Crunched      661   31%   10-10-86  14:00:10
  168.           ASYNC.COM         4106  Crunched     3105   25%   10-10-86  14:05:26
  169.           ASYNC.DOC         4422  Crunched     1800   60%   10-10-86  14:33:44
  170.           FMARK.COM          640  Crunched      407   37%   07-20-86  13:33:40
  171.           FORKP.C           2477  Crunched     1419   43%   09-25-86  09:19:10
  172.           HANDLER.ASM       3583  Crunched     1831   49%   10-10-86  09:55:54
  173.           INTCOMM.C         3335  Crunched     1746   48%   10-10-86  08:37:16
  174.           MAKEFILE           246  Crunched      184   26%   10-10-86  14:33:24
  175.           MARK.COM          1408   Packed       174   88%   07-20-86  13:33:02
  176.           MINT.C            3001  Crunched     1589   48%   10-10-86  13:09:06
  177.           RELEASE.COM      16647  Squeezed    15914    5%   07-20-86  13:32:36
  178.           STKSIZ.C          1011  Crunched      697   32%   10-09-86  13:41:32
  179.           TEST.BAT           247  Crunched      162   35%   10-10-86  14:19:12
  180.           TSR.DOC          14675  Crunched     7166   52%   09-07-86  13:01:30
  181.           _CROOT.C          2068  Crunched     1269   39%   09-24-86  16:00:30
  182.  
  183.      NOTES         NOTES  
  184.  
  185.           async com                                                               async.com was prepared using AZTEC C86. Debugging  was  done
  186.           with ATRON's software probe software.  
  187.  
  188.           This program was written by: 
  189.  
  190.                Kent  Williams  722  Rundell  Iowa City, IA 52240 (319)
  191.                338-6053 
  192.  
  193.                The mark and  release  utilities  were  extracted  from
  194.  
  195.  
  196.                                       -2-
  197.  
  198.  
  199.           ASYNC (1)          ASYNC BIOS REPLACEMENT          ASYNC (1)
  200.  
  201.  
  202.                TSRCOM.ARC  -  which  is  floating around in FIDO-land.
  203.                They  are  included  here   as   a   service,   without
  204.                permission.  
  205.  
  206.           RETURN VALUE              RETURN VALUE  
  207.  
  208.                None 
  209.                
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                       -3-
  263.  
  264.